home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / putctl.z / putctl
Encoding:
Text File  |  1998-10-30  |  6.1 KB  |  131 lines
  1.  
  2.  
  3.  
  4. ppppuuuuttttccccttttllll((((DDDD3333))))                                                          ppppuuuuttttccccttttllll((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_uuuu_tttt_cccc_tttt_llll - send a control message to a queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _pppp_uuuu_tttt_cccc_tttt_llll_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _iiii_nnnn_tttt _t_y_p_e_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _q         Pointer to the queue to which the message is to be sent.
  18.  
  19.      _t_y_p_e      Message type (must be a control type).
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _pppp_uuuu_tttt_cccc_tttt_llll tests the _t_y_p_e argument to make sure a data type has not been
  23.      specified, and then attempts to allocate a message block.  _pppp_uuuu_tttt_cccc_tttt_llll fails
  24.      if _t_y_p_e is _MMMM______DDDD_AAAA_TTTT_AAAA, _MMMM______PPPP_RRRR_OOOO_TTTT_OOOO, or _MMMM______PPPP_CCCC_PPPP_RRRR_OOOO_TTTT_OOOO, or if a message block cannot be
  25.      allocated.  If successful, _pppp_uuuu_tttt_cccc_tttt_llll calls the _pppp_uuuu_tttt(D2) routine of the queue
  26.      pointed to by _q, passing it the allocated message.
  27.  
  28.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  29.      On success, 1 is returned.  Otherwise, if _t_y_p_e is a data type, or if a
  30.      message block cannot be allocated, 0 is returned.
  31.  
  32.    LLLLeeeevvvveeeellll
  33.      Base or Interrupt.
  34.  
  35.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  36.      Does not sleep.
  37.  
  38.      Driver-defined basic locks, read/write locks, and sleep locks may not be
  39.      held across calls to this function.
  40.  
  41.    EEEExxxxaaaammmmpppplllleeeessss
  42.      The _ssss_eeee_nnnn_dddd______cccc_tttt_llll routine is used to pass control messages downstream.
  43.      _MMMM______BBBB_RRRR_EEEE_AAAA_KKKK messages are handled with _pppp_uuuu_tttt_cccc_tttt_llll (line 9).  _pppp_uuuu_tttt_cccc_tttt_llll_1111 (line 11) is
  44.      used for _MMMM______DDDD_EEEE_LLLL_AAAA_YYYY messages, so that _p_a_r_a_m can be used to specify the
  45.      length of the delay.  If an invalid message type is detected, _ssss_eeee_nnnn_dddd______cccc_tttt_llll
  46.      returns 0, indicating failure (line 13).
  47.       _1111  _iiii_nnnn_tttt
  48.       _2222  _ssss_eeee_nnnn_dddd______cccc_tttt_llll_((((_wwww_rrrr_qqqq_,,,, _tttt_yyyy_pppp_eeee_,,,, _pppp_aaaa_rrrr_aaaa_mmmm_))))
  49.       _3333   _qqqq_uuuu_eeee_uuuu_eeee______tttt _****_wwww_rrrr_qqqq_;;;;
  50.       _4444   _uuuu_cccc_hhhh_aaaa_rrrr______tttt _tttt_yyyy_pppp_eeee_;;;;
  51.       _5555   _uuuu_cccc_hhhh_aaaa_rrrr______tttt _pppp_aaaa_rrrr_aaaa_mmmm_;;;;
  52.       _6666  _{{{{
  53.       _7777   _ssss_wwww_iiii_tttt_cccc_hhhh _((((_tttt_yyyy_pppp_eeee_)))) _{{{{
  54.       _8888   _cccc_aaaa_ssss_eeee _MMMM______BBBB_RRRR_EEEE_AAAA_KKKK_::::
  55.       _9999        _rrrr_eeee_tttt_uuuu_rrrr_nnnn_((((_pppp_uuuu_tttt_cccc_tttt_llll_((((_wwww_rrrr_qqqq_----_>>>>_qqqq______nnnn_eeee_xxxx_tttt_,,,, _MMMM______BBBB_RRRR_EEEE_AAAA_KKKK_))))_))))_;;;;
  56.      _1111_0000   _cccc_aaaa_ssss_eeee _MMMM______DDDD_EEEE_LLLL_AAAA_YYYY_::::
  57.      _1111_1111        _rrrr_eeee_tttt_uuuu_rrrr_nnnn_((((_pppp_uuuu_tttt_cccc_tttt_llll_1111_((((_wwww_rrrr_qqqq_----_>>>>_qqqq______nnnn_eeee_xxxx_tttt_,,,, _MMMM______DDDD_EEEE_LLLL_AAAA_YYYY_,,,, _pppp_aaaa_rrrr_aaaa_mmmm_))))_))))_;;;;
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. ppppuuuuttttccccttttllll((((DDDD3333))))                                                          ppppuuuuttttccccttttllll((((DDDD3333))))
  69.  
  70.  
  71.  
  72.      _1111_2222   _dddd_eeee_ffff_aaaa_uuuu_llll_tttt_::::
  73.      _1111_3333        _rrrr_eeee_tttt_uuuu_rrrr_nnnn_((((_0000_))))_;;;;
  74.      _1111_4444   _}}}}
  75.      _1111_5555  _}}}}
  76.  
  77. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  78.      _pppp_uuuu_tttt(D2), _pppp_uuuu_tttt_cccc_tttt_llll_1111(D3)
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.